草庐IT

PHPDoc 和 __callStatic

全部标签

PHPDoc:用可变数量的参数记录函数

记录接受可变数量参数的类方法的推荐方法是什么?也许是这样的?注意:作为一般规则,我认为应该尽可能避免这种类型的事情。话虽这么说,但最好还是记录其余少数无法避免的情况。 最佳答案 如果您使用可变数量的参数并且还使用PHP>=5.6那么您可以使用仍然符合PHPDoc的可变参数函数(允许可变数量的参数),...语法已经提到,PHPStorm也将正确解释文档。使用可变参数函数无需func_get_args()将参数捕获到数组中。/***@parammixed$args,...Explainatorium!*/functionvariadic

PHPDoc:用可变数量的参数记录函数

记录接受可变数量参数的类方法的推荐方法是什么?也许是这样的?注意:作为一般规则,我认为应该尽可能避免这种类型的事情。话虽这么说,但最好还是记录其余少数无法避免的情况。 最佳答案 如果您使用可变数量的参数并且还使用PHP>=5.6那么您可以使用仍然符合PHPDoc的可变参数函数(允许可变数量的参数),...语法已经提到,PHPStorm也将正确解释文档。使用可变参数函数无需func_get_args()将参数捕获到数组中。/***@parammixed$args,...Explainatorium!*/functionvariadic

php - 在 PHPDoc 中记录数组选项的最佳方式?

我正在努力编写可读且易于理解的文档来描述传递给函数的数组选项的多树结构。这是一个示例数组结构。$arr=['fields'=>['title'=>['name'=>'Document.title','format'=>'string','readonly'=>true]]];上面的数组有很多可能的选项,但它被用作理解该结构的函数的参数。functiondoSomething(array$arr){...}我想在PHPDoc中记录数组的结构,但我不确定正确的方法是什么。这是我现在拥有的。/***Holdsconfigurationsettingsforeachfieldinamodel.

php - 在 PHPDoc 中记录数组选项的最佳方式?

我正在努力编写可读且易于理解的文档来描述传递给函数的数组选项的多树结构。这是一个示例数组结构。$arr=['fields'=>['title'=>['name'=>'Document.title','format'=>'string','readonly'=>true]]];上面的数组有很多可能的选项,但它被用作理解该结构的函数的参数。functiondoSomething(array$arr){...}我想在PHPDoc中记录数组的结构,但我不确定正确的方法是什么。这是我现在拥有的。/***Holdsconfigurationsettingsforeachfieldinamodel.

php - 使用 PhpDoc 记录 PHP 多重继承

我有像这样的多重继承:CanIextendaclassusingmorethan1classinPHP?(请不要讨论这种方法本身)并希望我的IDE了解继承的类方法和属性。有没有办法用PhpDoc做到这一点? 最佳答案 目前看来没有办法轻松做到。我在PhpStorm问题跟踪器上创建了一张票。也许他们会添加对此功能的支持。http://youtrack.jetbrains.net/issue/WI-1730 关于php-使用PhpDoc记录PHP多重继承,我们在StackOverflow上找

php - PHPDoc 中严格类型实体的提示迭代器

细节我正在使用PHPStorm8IDE。假设我们有一些实现了\Iterator的类Foo接口(interface),我们知道该迭代器中的所有项目都是Bar类的实例。问题如何提示Foo是可迭代的并且只包含Bar的项目?当然,提示应该保留信息,它是Foo的实例到目前为止我尝试了什么如果我们有一个Bar实例数组,那么这很容易(例如,在this问题中对其进行了描述):Bar[]。此外,如果打算遍历Foo,它仍然可以(或多或少)解决://assumethat$fooisinstanceofFoo//../*@var$objectBar*/foreach($fooas$object){}但是,有一

phpdoc:记录常量的正确方法是什么

是否有适当的方法来记录使用define()定义的常量?@var真的没有意义。我唯一能想到的就是省略标签,只在PHPdoc注释中写描述。 最佳答案 phpDocumentor不识别或使用@const标签。当phpDocumentor在代码中看到“define”关键字时,它会识别出一个常量。它的输出模板将显示输出文档中的所有常量,列为常量。常量的docblock中唯一需要的是描述,但如果您觉得需要,也允许使用许多其他“标准”标签[1]。[1]--http://manual.phpdoc.org/HTMLSmartyConverter/H

php - 还有什么比 PHPDoc 更好的吗?

关闭。这个问题不符合StackOverflowguidelines.它目前不接受答案。我们不允许提问寻求书籍、工具、软件库等的推荐。您可以编辑问题,以便用事实和引用来回答。关闭7年前。Improvethisquestion除PHPDoc外,还有其他任何东西来记录他们的PHP代码吗?是否有任何工具可以读取相同的文档语法但提供更丰富的输出?

php - 如何告诉 phpDoc 一个字符串是一个类名?

我经常给对象赋予静态方法和属性,不需要对象进行初始化。例如:classSomeObject{publicfunction__construct($object_id){$this->loadProperties($object_id);}publicstaticfunctiongetSomeStaticString(){return"somestaticstring";}}现在我们对这些对象进行子类化,并有某种Controller在某些情况下返回一个对象类字符串,此时对象还不应该被初始化。例如:classSomeObjectController{publicfunctiongetSom

php - 在同一个类中调用 __call 而不是 __callstatic,而不是调用另一个类

我有一个关于奇怪行为的问题。看这段代码:classUser{publicfunctioncan($name){returncall_user_func(array($name,'test'));}publicstaticfunction__callStatic($name,$args){return'User::__callStatic';}publicfunction__call($name,$args){return'User::__call';}}classFoo{publicstaticfunction__callStatic($name,$args){return'Foo::